package com.jpro.module.bpm.api.task.rpc;

import com.jpro.framework.common.pojo.CommonResult;
import com.jpro.module.bpm.api.task.dto.BpmProcessInstanceRpcCreateReqDTO;
import com.jpro.module.bpm.api.task.enums.ApiConstants;
import io.swagger.v3.oas.annotations.Operation;
import io.swagger.v3.oas.annotations.Parameter;
import io.swagger.v3.oas.annotations.tags.Tag;
import org.springframework.cloud.openfeign.FeignClient;
import org.springframework.web.bind.annotation.PostMapping;
import org.springframework.web.bind.annotation.RequestBody;

/**
 * 流程实例 Api 接口
 *
 * @author JPROCMS
 */
@FeignClient(name = ApiConstants.NAME)
@Tag(name = "RPC 服务 - 工作流")
public interface BpmProcessInstanceRpcApi {

    /**
     * 创建流程实例（提供给外部）
     *
     * @param userId 用户编号
     * @param reqDTO 创建信息
     * @return 实例的编号
     */

    String PREFIX = ApiConstants.PREFIX + "/processInstance";

    @PostMapping(PREFIX + "/create")
    @Operation(summary = "创建流程实例")
    @Parameter(name = "id", description = "用户创建流程信息", required = true)
    CommonResult<String> createProcessInstance(@RequestBody BpmProcessInstanceRpcCreateReqDTO reqDTO);
}
